home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / docs / misc / ahiman.readme < prev    next >
Text File  |  1998-01-05  |  9KB  |  213 lines
  1. Short:    Retargetable audio v4.16, Doc. Archive
  2. Author:   Martin Blom <lcs@lysator.liu.se>
  3. Uploader: Martin Blom <lcs@lysator.liu.se>
  4. Type:     docs/misc
  5.  
  6.      This archive contains the documentation for AHI (both
  7.      AHI Developer's Guide and AHI User's Guide) as DVI,
  8.      Postscript and HTML files.
  9.  
  10.      AmigaGuide® versions are included in the AHI Developer's
  11.      archive and the AHI User's archive.
  12.  
  13.      Changes since last release
  14.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  15.      Bug fixes in the device code.
  16.      Updated documentation.
  17.      New translation (hrvatski).
  18.      Added driver for Maestro Pro to the distribution.
  19.      Added driver for Concierto to the distribution.
  20.  
  21.  
  22. TITLE
  23.  
  24.      AHI Audio system
  25.  
  26. VERSION
  27.  
  28.      Release 4
  29.  
  30. AUTHOR
  31.  
  32.      Martin Blom <lcs@lysator.liu.se>
  33.  
  34. DESCRIPTION
  35.  
  36.      Retargetable Audio for AmigaOS
  37.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  38.  
  39.      (When refering to this software, the correct term is
  40.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  41.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  42.  
  43.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  44.      However, many features are lacking:
  45.  
  46.      · Very limited volime control when using 16 bit samples
  47.      · No HiFi mixing routines are available.
  48.      · No stereo samples
  49.      · No DSP effects are available.
  50.      · Less precision on some calculations
  51.      · Slower
  52.  
  53.      As you can see, this version is very primitive.  Get yourself an
  54.      accelerator!  I cannot guarantee that I will continue to support this
  55.      processor in the future.
  56.  
  57.      Quick overview
  58.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  59.  
  60.      * Driver based
  61.  
  62.      Each supported sound card is controlled by a library-based audio
  63.      driver. For a 'dumb' sound card, a new driver should be written in
  64.      a few hours. For a 'smart' sound card, it is possible to utilize an
  65.      on-board DSP, for example, to maximize performance and sound quality.
  66.      For sound cards with own DSP but little or no memory, it is possible
  67.      to use the main CPU to mix channels and do the post-processing
  68.      with the DSP. Available today are drivers for
  69.  
  70.      · Aura (sampler only)
  71.      · Clarity (sampler only)
  72.      · Concierto (Picasso IV sound module)
  73.      · Delfina DSP and Delfina Lite
  74.      · DraCo Motion
  75.      · Maestro Pro
  76.      · Melody MPEG
  77.      · Paula (8/14/14c bit)
  78.      · Prelude
  79.      · Toccata
  80.      · Wavetools
  81.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  82.  
  83.      * Fast, powerful mixing routines (yeah, right... haha)
  84.  
  85.      The device's mixing routines mix 8- or 16-bit signed samples, both
  86.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  87.      (with stereo panning if desired) data, using any number of channels
  88.      (as long as 'any' means less than 128...).  Tables can be used speed
  89.      the mixing up (especially when using 8-bit samples).  The samples can
  90.      have any length (including odd) and can have any number of loops.
  91.      
  92.      * Support for non-realtime mixing
  93.  
  94.      By providing a timing feature, it is possible to create high-
  95.      quality output even if the processing power is lacking, by saving
  96.      the output to disk, for example as an IFF AIFF or 8SXV file.
  97.      There are so-called HiFi mixing routines that can be used, which
  98.      use linear interpolation and gives 32 bit output.
  99.  
  100.      * Audio database
  101.  
  102.      Uses ID codes, much like Screenmode IDs, to select the many
  103.      parameters that can be set. The functions to access the audio
  104.      database are not too different from those in 'graphics.library'.
  105.      The device also features a requester to get an ID code from the
  106.      user.
  107.  
  108.      * Both high- and low-level protocol
  109.  
  110.      By acting both like a device and a library, AHI gives the programmer
  111.      a choice between full control and simplicity. The device API allows
  112.      several programs to use the audio hardware at the same time, and
  113.      the AUDIO: dos-device driver makes playing and recording sound very
  114.      simple for both the programmer and user.
  115.  
  116.      * Future Compatible
  117.  
  118.      When AmigaOS gets device-independent audio worth it's name, it should
  119.      not be too difficult to write a driver for AHI, allowing applications
  120.      using 'ahi.device' to automatically use the new OS interface. At
  121.      least I hope it wont.
  122.  
  123. SPECIAL REQUIREMENTS
  124.  
  125.      AmigaOS release 2.
  126.      MC68020 processor or better strongly recommended.
  127.  
  128. AVAILABILITY
  129.  
  130.      Aminet, for example:
  131.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  132.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  133.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  134.  
  135.      WWW:
  136.      http://www.lysator.liu.se/~lcs/ahi.html
  137.  
  138. PRICE
  139.  
  140.      Free. But if you use it in a shareware of commercial product,
  141.      I would like a registered copy for me and each of the audio driver
  142.      authors (this is merely a wish, you don't have to do it if you don't
  143.      think we deserve it). See the AHI User's Guide for more information.
  144.  
  145. DISTRIBUTABILITY
  146.  
  147.      Copyright ©1994-1997 Martin Blom.
  148.      Freely distributable in unmodified form.
  149.      See the AHI User's Guide for more information.
  150.  
  151.  
  152. ============================= Archive contents =============================
  153.  
  154. Original  Packed Ratio    Date     Time    Name
  155. -------- ------- ----- --------- --------  -------------
  156.     5139    2361 54.0% 08-Nov-97 00:15:00 +ahiman.readme
  157.    95312   23138 75.7% 04-Nov-97 23:19:36 +ahidev.dvi
  158.    82620   23274 71.8% 04-Nov-97 23:19:36 +ahiusr.dvi
  159.     3546    1384 60.9% 04-Nov-97 23:19:38 +ahidev_1.html
  160.     7219    2692 62.7% 04-Nov-97 23:19:38 +ahidev_10.html
  161.     1858     833 55.1% 04-Nov-97 23:19:38 +ahidev_11.html
  162.     2876    1147 60.1% 04-Nov-97 23:19:38 +ahidev_12.html
  163.     2925    1097 62.4% 04-Nov-97 23:19:38 +ahidev_13.html
  164.     5438    2070 61.9% 04-Nov-97 23:19:38 +ahidev_14.html
  165.     1102     460 58.2% 04-Nov-97 23:19:38 +ahidev_15.html
  166.     1804     728 59.6% 04-Nov-97 23:19:38 +ahidev_16.html
  167.     1855     825 55.5% 04-Nov-97 23:19:38 +ahidev_17.html
  168.     3654     987 72.9% 04-Nov-97 23:19:38 +ahidev_18.html
  169.     1214     455 62.5% 04-Nov-97 23:19:38 +ahidev_19.html
  170.     2559    1192 53.4% 04-Nov-97 23:19:38 +ahidev_2.html
  171.     1420     474 66.6% 04-Nov-97 23:19:38 +ahidev_20.html
  172.     3791     839 77.8% 04-Nov-97 23:19:38 +ahidev_21.html
  173.     1157     526 54.5% 04-Nov-97 23:19:38 +ahidev_3.html
  174.     1719     760 55.7% 04-Nov-97 23:19:38 +ahidev_4.html
  175.     1810     764 57.7% 04-Nov-97 23:19:38 +ahidev_5.html
  176.     3110    1223 60.6% 04-Nov-97 23:19:38 +ahidev_6.html
  177.     2721    1078 60.3% 04-Nov-97 23:19:38 +ahidev_7.html
  178.     6362    2212 65.2% 04-Nov-97 23:19:38 +ahidev_8.html
  179.     4597    1779 61.3% 04-Nov-97 23:19:38 +ahidev_9.html
  180.      769     461 40.0% 04-Nov-97 23:19:38 +ahidev_foot.html
  181.     3746    1172 68.7% 04-Nov-97 23:19:38 +ahidev_toc.html
  182.     3596    1626 54.7% 04-Nov-97 23:19:40 +ahiusr_1.html
  183.     1149     524 54.3% 04-Nov-97 23:19:40 +ahiusr_10.html
  184.     1134     473 58.2% 04-Nov-97 23:19:40 +ahiusr_11.html
  185.      927     390 57.9% 04-Nov-97 23:19:40 +ahiusr_12.html
  186.     1983     876 55.8% 04-Nov-97 23:19:40 +ahiusr_13.html
  187.     2702    1246 53.8% 04-Nov-97 23:19:40 +ahiusr_14.html
  188.     4635    1837 60.3% 04-Nov-97 23:19:40 +ahiusr_15.html
  189.     1674     651 61.1% 04-Nov-97 23:19:40 +ahiusr_16.html
  190.     6263    2420 61.3% 04-Nov-97 23:19:40 +ahiusr_17.html
  191.     4226    1718 59.3% 04-Nov-97 23:19:40 +ahiusr_18.html
  192.     1389     591 57.4% 04-Nov-97 23:19:40 +ahiusr_19.html
  193.     2615    1201 54.0% 04-Nov-97 23:19:40 +ahiusr_2.html
  194.     2256    1095 51.4% 04-Nov-97 23:19:40 +ahiusr_20.html
  195.     1405     616 56.1% 04-Nov-97 23:19:40 +ahiusr_21.html
  196.     2137     993 53.5% 04-Nov-97 23:19:40 +ahiusr_22.html
  197.     2228    1150 48.3% 04-Nov-97 23:19:40 +ahiusr_23.html
  198.     2059     805 60.9% 04-Nov-97 23:19:40 +ahiusr_24.html
  199.     6222    1513 75.6% 04-Nov-97 23:19:40 +ahiusr_25.html
  200.     1286     617 52.0% 04-Nov-97 23:19:40 +ahiusr_3.html
  201.     1124     455 59.5% 04-Nov-97 23:19:40 +ahiusr_4.html
  202.     2318    1049 54.7% 04-Nov-97 23:19:40 +ahiusr_5.html
  203.     2552    1070 58.0% 04-Nov-97 23:19:40 +ahiusr_6.html
  204.      988     375 62.0% 04-Nov-97 23:19:40 +ahiusr_7.html
  205.     1431     635 55.6% 04-Nov-97 23:19:40 +ahiusr_8.html
  206.     1177     480 59.2% 04-Nov-97 23:19:40 +ahiusr_9.html
  207.     3480    1480 57.4% 04-Nov-97 23:19:40 +ahiusr_foot.html
  208.     2279     804 64.7% 04-Nov-97 23:19:40 +ahiusr_toc.html
  209.   218663   82944 62.0% 04-Nov-97 23:19:36 +ahidev.ps
  210.   196307   76388 61.0% 04-Nov-97 23:19:38 +ahiusr.ps
  211. -------- ------- ----- --------- --------
  212.   730528  259953 64.4% 11-Nov-97 22:23:36   55 files
  213.